<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<title>nrf51/Source/ext_sensors/ds1624/ds1624.c Source File</title>
<link href="tabs.css" rel="stylesheet" type="text/css" />
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="alias.css" rel="stylesheet" type="text/css" />
<script type="text/javascript" src="alias.js"></script>

<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<script type="text/javascript">
  $(document).ready(initResizable);
</script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/search.js"></script>
<script type="text/javascript">
  $(document).ready(function() { searchBox.OnSelectItem(0); });
</script>


<script type="text/javascript">
  jQuery(document).ready(function () {
    if(gref){ // Number all _img and _table classes
      gref();
    }
  });
</script>

</head>
<body>
<div id="top"><!-- do not remove this div! -->

<div id="titlearea">
<table cellspacing="0" cellpadding="0">
 <tbody>
 <tr style="height: 56px;">
  
  
  <td style="padding-left: 0.5em;">
   <div id="projectname">nRF51 General Code Examples
   
   </div>
   
  </td>
  
  
  
 </tr>
 </tbody>
</table>
</div>

<!-- Generated by Doxygen 1.7.5 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
  <div id="navrow1" class="tabs">
    <ul class="tablist">
      <li><a href="index.html"><span>Main&#160;Page</span></a></li>
      <li><a href="modules.html"><span>Modules</span></a></li>
      <li><a href="annotated.html"><span>Data&#160;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li>
        <div id="MSearchBox" class="MSearchBoxInactive">
        <span class="left">
          <img id="MSearchSelect" src="search/mag_sel.png"
               onmouseover="return searchBox.OnSearchSelectShow()"
               onmouseout="return searchBox.OnSearchSelectHide()"
               alt=""/>
          <input type="text" id="MSearchField" value="Search" accesskey="S"
               onfocus="searchBox.OnSearchFieldFocus(true)" 
               onblur="searchBox.OnSearchFieldFocus(false)" 
               onkeyup="searchBox.OnSearchFieldChange(event)"/>
          </span><span class="right">
            <a id="MSearchClose" href="javascript:searchBox.CloseResultsWindow()"><img id="MSearchCloseImg" border="0" src="search/close.png" alt=""/></a>
          </span>
        </div>
      </li>
    </ul>
  </div>
  <div id="navrow2" class="tabs2">
    <ul class="tablist">
      <li><a href="files.html"><span>File&#160;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
</div>
<div id="side-nav" class="ui-resizable side-nav-resizable">
  <div id="nav-tree">
    <div id="nav-tree-contents">
    </div>
  </div>
  <div id="splitbar" style="-moz-user-select:none;" 
       class="ui-resizable-handle">
  </div>
</div>
<script type="text/javascript">
  initNavTree('ds1624_8c.html','');
</script>
<div id="doc-content">
<div class="header">
  <div class="headertitle">
<div class="title">nrf51/Source/ext_sensors/ds1624/ds1624.c</div>  </div>
</div>
<div class="contents">
<div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="preprocessor">#include &quot;<a class="code" href="ds1624_8h.html" title="DS1624 digital temperature sensor driver.">ds1624.h</a>&quot;</span>
<a name="l00002"></a>00002 <span class="preprocessor">#include &quot;<a class="code" href="twi__master_8h.html" title="Software controlled TWI Master driver.">twi_master.h</a>&quot;</span>
<a name="l00003"></a>00003 <span class="preprocessor">#include &quot;nrf_delay.h&quot;</span>
<a name="l00004"></a>00004 
<a name="l00005"></a>00005 <span class="comment">/*lint ++flb &quot;Enter library region&quot; */</span>
<a name="l00006"></a>00006 
<a name="l00007"></a>00007 <span class="preprocessor">#define DS1634_BASE_ADDRESS 0x90 //!&lt; 4 MSBs of the DS1624 TWI address</span>
<a name="l00008"></a>00008 <span class="preprocessor"></span>
<a name="l00009"></a>00009 <span class="preprocessor">#define DS1624_ONESHOT_MODE 0x01 //!&lt; Bit in configuration register for 1-shot mode </span>
<a name="l00010"></a>00010 <span class="preprocessor"></span><span class="preprocessor">#define DS1624_CONVERSION_DONE 0x80 //!&lt; Bit in configuration register to indicate completed temperature conversion</span>
<a name="l00011"></a>00011 <span class="preprocessor"></span>
<a name="l00012"></a>00012 <span class="keyword">static</span> uint8_t m_device_address; 
<a name="l00013"></a>00013 
<a name="l00014"></a>00014 <span class="keyword">const</span> uint8_t command_access_memory = 0x17; 
<a name="l00015"></a>00015 <span class="keyword">const</span> uint8_t command_access_config = 0xAC; 
<a name="l00016"></a>00016 <span class="keyword">const</span> uint8_t command_read_temp = 0xAA; 
<a name="l00017"></a>00017 <span class="keyword">const</span> uint8_t command_start_convert_temp = 0xEE; 
<a name="l00018"></a>00018 <span class="keyword">const</span> uint8_t command_stop_convert_temp = 0x22; 
<a name="l00019"></a>00019 
<a name="l00025"></a>00025 <span class="keyword">static</span> uint8_t ds1624_config_read(<span class="keywordtype">void</span>)
<a name="l00026"></a>00026 {
<a name="l00027"></a>00027   uint8_t config = 0;
<a name="l00028"></a>00028     
<a name="l00029"></a>00029   <span class="comment">// Write: command protocol</span>
<a name="l00030"></a>00030   <span class="keywordflow">if</span> (<a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, (uint8_t*)&amp;command_access_config, 1, <a class="code" href="group__lib__driver__twi__master.html#gaedaa985feb5cea808d8811bd7ceeb318" title="Parameter for twi_master_transfer.">TWI_DONT_ISSUE_STOP</a>))
<a name="l00031"></a>00031   {
<a name="l00032"></a>00032     <span class="keywordflow">if</span> (<a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address | <a class="code" href="group__lib__driver__twi__master.html#ga67c0f91739433360f513b097acf11946" title="If this bit is set in the address field, transfer direction is from slave to master.">TWI_READ_BIT</a>, &amp;config, 1, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>)) <span class="comment">// Read: current configuration</span>
<a name="l00033"></a>00033     {
<a name="l00034"></a>00034       <span class="comment">// Read succeeded, configuration stored to variable &quot;config&quot;</span>
<a name="l00035"></a>00035     }
<a name="l00036"></a>00036     <span class="keywordflow">else</span>
<a name="l00037"></a>00037     {
<a name="l00038"></a>00038       <span class="comment">// Read failed</span>
<a name="l00039"></a>00039       config = 0;
<a name="l00040"></a>00040     }
<a name="l00041"></a>00041   } 
<a name="l00042"></a>00042 
<a name="l00043"></a>00043   <span class="keywordflow">return</span> config;
<a name="l00044"></a>00044 }
<a name="l00045"></a>00045 
<a name="l00046"></a><a class="code" href="group__nrf__drivers__ds1624.html#ga0ea8c0c4d140fde9b5b575caed79de6a">00046</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__ds1624.html#ga0ea8c0c4d140fde9b5b575caed79de6a">ds1624_init</a>(uint8_t device_address)
<a name="l00047"></a>00047 {
<a name="l00048"></a>00048   <span class="keywordtype">bool</span> transfer_succeeded = <span class="keyword">true</span>;
<a name="l00049"></a>00049   m_device_address = DS1634_BASE_ADDRESS + (uint8_t)(device_address &lt;&lt; 1);
<a name="l00050"></a>00050 
<a name="l00051"></a>00051   uint8_t config = ds1624_config_read();  
<a name="l00052"></a>00052 
<a name="l00053"></a>00053   <span class="keywordflow">if</span> (config != 0)
<a name="l00054"></a>00054   {
<a name="l00055"></a>00055     <span class="comment">// Configure DS1624 for 1SHOT mode if not done so already.</span>
<a name="l00056"></a>00056     <span class="keywordflow">if</span> (!(config &amp; DS1624_ONESHOT_MODE))
<a name="l00057"></a>00057     {
<a name="l00058"></a>00058       uint8_t data_buffer[2];
<a name="l00059"></a>00059   
<a name="l00060"></a>00060       data_buffer[0] = command_access_config;
<a name="l00061"></a>00061       data_buffer[1] = DS1624_ONESHOT_MODE;
<a name="l00062"></a>00062   
<a name="l00063"></a>00063       transfer_succeeded &amp;= <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, data_buffer, 2, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>);
<a name="l00064"></a>00064     }
<a name="l00065"></a>00065   }
<a name="l00066"></a>00066   <span class="keywordflow">else</span>
<a name="l00067"></a>00067   {
<a name="l00068"></a>00068     transfer_succeeded = <span class="keyword">false</span>;
<a name="l00069"></a>00069   }
<a name="l00070"></a>00070 
<a name="l00071"></a>00071   <span class="keywordflow">return</span> transfer_succeeded;
<a name="l00072"></a>00072 }
<a name="l00073"></a>00073 
<a name="l00074"></a><a class="code" href="group__nrf__drivers__ds1624.html#gace297981d492fc044ba97a1954f98c83">00074</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__ds1624.html#gace297981d492fc044ba97a1954f98c83">ds1624_start_temp_conversion</a>(<span class="keywordtype">void</span>)
<a name="l00075"></a>00075 {
<a name="l00076"></a>00076   <span class="keywordflow">return</span> <a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, (uint8_t*)&amp;command_start_convert_temp, 1, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>);
<a name="l00077"></a>00077 }
<a name="l00078"></a>00078 
<a name="l00079"></a><a class="code" href="group__nrf__drivers__ds1624.html#ga9ac065c4738652386d500c9b35447ada">00079</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__ds1624.html#ga9ac065c4738652386d500c9b35447ada">ds1624_is_temp_conversion_done</a>(<span class="keywordtype">void</span>)
<a name="l00080"></a>00080 {
<a name="l00081"></a>00081   uint8_t config = ds1624_config_read();
<a name="l00082"></a>00082 
<a name="l00083"></a>00083   <span class="keywordflow">if</span> (config &amp; DS1624_CONVERSION_DONE)
<a name="l00084"></a>00084   {
<a name="l00085"></a>00085     <span class="keywordflow">return</span> <span class="keyword">true</span>;
<a name="l00086"></a>00086   }
<a name="l00087"></a>00087   <span class="keywordflow">else</span>
<a name="l00088"></a>00088   {
<a name="l00089"></a>00089     <span class="keywordflow">return</span> <span class="keyword">false</span>;
<a name="l00090"></a>00090   }
<a name="l00091"></a>00091 }
<a name="l00092"></a>00092 
<a name="l00093"></a><a class="code" href="group__nrf__drivers__ds1624.html#ga554dc82a94c2878635c336b0fb691144">00093</a> <span class="keywordtype">bool</span> <a class="code" href="group__nrf__drivers__ds1624.html#ga554dc82a94c2878635c336b0fb691144">ds1624_temp_read</a>(int8_t *temperature_in_celcius, int8_t *temperature_fraction)
<a name="l00094"></a>00094 {
<a name="l00095"></a>00095   <span class="keywordtype">bool</span> transfer_succeeded = <span class="keyword">false</span>;
<a name="l00096"></a>00096 
<a name="l00097"></a>00097   <span class="comment">// Write: Begin read temperature command</span>
<a name="l00098"></a>00098   <span class="keywordflow">if</span> (<a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address, (uint8_t*)&amp;command_read_temp, 1, <a class="code" href="group__lib__driver__twi__master.html#gaedaa985feb5cea808d8811bd7ceeb318" title="Parameter for twi_master_transfer.">TWI_DONT_ISSUE_STOP</a>))
<a name="l00099"></a>00099   {
<a name="l00100"></a>00100     uint8_t data_buffer[2];
<a name="l00101"></a>00101 
<a name="l00102"></a>00102     <span class="comment">// Read: 2 temperature bytes to data_buffer</span>
<a name="l00103"></a>00103     <span class="keywordflow">if</span> (<a class="code" href="group__lib__driver__twi__master.html#ga36e8039d4cbb4f66c0cf0cf1e3a72445">twi_master_transfer</a>(m_device_address | <a class="code" href="group__lib__driver__twi__master.html#ga67c0f91739433360f513b097acf11946" title="If this bit is set in the address field, transfer direction is from slave to master.">TWI_READ_BIT</a>, data_buffer, 2, <a class="code" href="group__lib__driver__twi__master.html#ga13a824cf1c6a37f2ddea21c962128a3e" title="Parameter for twi_master_transfer.">TWI_ISSUE_STOP</a>)) 
<a name="l00104"></a>00104     {
<a name="l00105"></a>00105       *temperature_in_celcius = (int8_t)data_buffer[0];
<a name="l00106"></a>00106       *temperature_fraction = (int8_t)data_buffer[1];
<a name="l00107"></a>00107       
<a name="l00108"></a>00108       transfer_succeeded = <span class="keyword">true</span>;
<a name="l00109"></a>00109     }
<a name="l00110"></a>00110   }
<a name="l00111"></a>00111 
<a name="l00112"></a>00112   <span class="keywordflow">return</span> transfer_succeeded;
<a name="l00113"></a>00113 }
<a name="l00114"></a>00114 
<a name="l00115"></a>00115 <span class="comment">/*lint --flb &quot;Leave library region&quot; */</span> 
</pre></div></div>
</div>
  <div id="nav-path" class="navpath">
    <ul>
      <li class="navelem"><b>ds1624.c</b>      </li>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
     onmouseover="return searchBox.OnSearchSelectShow()"
     onmouseout="return searchBox.OnSearchSelectHide()"
     onkeydown="return searchBox.OnSearchSelectKey(event)">
<a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(0)"><span class="SelectionMark">&#160;</span>All</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(1)"><span class="SelectionMark">&#160;</span>Data Structures</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(2)"><span class="SelectionMark">&#160;</span>Files</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(3)"><span class="SelectionMark">&#160;</span>Functions</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(4)"><span class="SelectionMark">&#160;</span>Variables</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(5)"><span class="SelectionMark">&#160;</span>Enumerations</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(6)"><span class="SelectionMark">&#160;</span>Enumerator</a><a class="SelectItem" href="javascript:void(0)" onclick="searchBox.OnSelectItem(7)"><span class="SelectionMark">&#160;</span>Defines</a></div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0" 
        name="MSearchResults" id="MSearchResults">
</iframe>
</div>


    <li class="footer">
      Copyright &copy 2006-2011 <a href="http://www.nordicsemi.no" style="text-decoration:none">Nordic Semiconductor</a>.
      All Rights Reserved.
      <a href="disclaimer.html">Disclaimer</a>
    </li>
   </ul>
 </div>


</body>
</html>
